home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / programm.ing / cdbind01.zoo / cdromio.h < prev    next >
Encoding:
C/C++ Source or Header  |  1994-05-16  |  8.5 KB  |  286 lines
  1. /*
  2.     CD-ROM Fcntl()s and structures
  3.     
  4.     Copyright (c) Julian F. Reschke (jr@ms.maus.de), 16. Mai 1994
  5.     Free distribution and usage allowed as long as the file remains 
  6.     unchanged.
  7.  
  8.     These Fcntl() opcodes provide a *nix-like interface to the CD-ROM     
  9.     specific functions. They can be used either with a MiNT specific     
  10.     CD-ROM device driver or with new MetaDOS BOS lowlevel drivers. For 
  11.     MiNT mounted device drivers, the interface is
  12.     
  13.         Fcntl (short filehandle, short opcode, long arg)
  14.         
  15.     (with filehandle a handle to the opened CDROM device driver) or
  16.     
  17.         Dcntl (short opcode, char *name, long arg)
  18.     
  19.     (with name being the name of a file or directory on the mounted CD 
  20.     file system).
  21.         
  22.     For MetaDOS BOS drivers, the interface is
  23.     
  24.         xbios (0x37, short device, long magic, short opcode, long arg)
  25.     
  26.     where 'device' is a MetaDOS XBIOS device number ('A'..'Z') and 'magic' 
  27.     is 'FCTL'. With MetaDOS version >= 2.40 and the appropriate DOS 
  28.     drivers, you can also use the GEMDOS call Dcntl (thus being compatible 
  29.     to future MiNT drivers), because MetaDOS 2.40 implements some of the 
  30.     new GEMDOS calls and Atari's ISO9660F.DOS passes all Dcntl calls right 
  31.     down to the BOS driver.
  32.     
  33.     Note that there is an 'old' CD-ROM audio interface for MetaDOS, but 
  34.     the commands depend on the custom CDAR 504 controller and can't be 
  35.     fully implemented for SCSI drives (in fact they are, with some 
  36.     restrictions). Consult the MetaDOS developers manual for further 
  37.     information.
  38.     
  39.     In both cases, EINVFN (-32L) is returned for unknown opcodes.
  40.     
  41.     Note that MetaDOS drivers return EUNKNOWN (-3) if XBIOS opcode 0x37 is 
  42.     not supported!
  43.     
  44.     Drivers supporting this interface (send updates to jr@ms.maus.de):
  45.     
  46.     MetaDOS BOS drivers (driver name, company):
  47.  
  48.         HS-CDROM.BOS
  49.             Hard &Soft, Castrop-Rauxel, Germany
  50.             Generic driver for SCSI-CDROMs connected to ACSI or SCSI and 
  51.             for the CDAR504
  52.  
  53.         FX001???.BOS, CDU33???.BOS
  54.             Gellermann & Fellmuth GbR, Berlin, Germany
  55.             Drivers for Mitsumi drives connected to internal or parallel 
  56.             interface.
  57.  
  58.     MiNT device drivers (driver name, company):
  59.         -
  60. */
  61.  
  62. #ifndef _CDROMIO_H
  63. #define _CDROMIO_H
  64.  
  65. #ifndef BYTE
  66. #define BYTE unsigned char
  67. #endif
  68.  
  69. typedef union
  70. { 
  71.     struct {
  72.         BYTE  reserved, minute, second, frame;
  73.     } msf;
  74.     long lba;
  75. } cd_ad;
  76.  
  77. /* Data structures used */
  78.  
  79. struct cdrom_msf 
  80. {
  81.     BYTE    cdmsf_min0;     /* start minute */
  82.     BYTE    cdmsf_sec0;     /* start second */
  83.     BYTE    cdmsf_frame0;   /* start frame */
  84.     BYTE    cdmsf_min1;     /* end minute */
  85.     BYTE    cdmsf_sec1;     /* end second */
  86.     BYTE    cdmsf_frame1;   /* end frame */
  87. };
  88.  
  89. struct cdrom_ti 
  90. {
  91.     BYTE    cdti_trk0;      /* start track */
  92.     BYTE    cdti_ind0;      /* start index */
  93.     BYTE    cdti_trk1;      /* end track */
  94.     BYTE    cdti_ind1;      /* end index */
  95. };
  96.  
  97. struct cdrom_tochdr     
  98. {
  99.     BYTE    cdth_trk0;      /* start track */
  100.     BYTE    cdth_trk1;      /* end track */
  101. };
  102.  
  103. struct cdrom_tocentry 
  104. {
  105.     /* input parameters */
  106.  
  107.     BYTE    cdte_track;     /* track number or CDROM_LEADOUT */
  108.     BYTE    cdte_format;    /* CDROM_LBA or CDROM_MSF */
  109.     
  110.     /* output parameters */
  111.  
  112.     unsigned    cdte_adr:4;     /* the SUBQ channel encodes 0: nothing,
  113.                                     1: position data, 2: MCN, 3: ISRC,
  114.                                     else: reserved */
  115.     unsigned    cdte_ctrl:4;    /* bit 0: audio with pre-emphasis,
  116.                                     bit 1: digital copy permitted,
  117.                                     bit 2: data track,
  118.                                     bit 3: four channel */
  119.     BYTE    cdte_datamode;        /* currently not set */
  120.     cd_ad    cdte_addr;            /* track start */
  121. };
  122.  
  123. struct cdrom_subchnl 
  124. {
  125.     /* input parameters */
  126.  
  127.     BYTE    cdsc_format;        /* CDROM_MSF or CDROM_LBA */
  128.     
  129.     /* output parameters */
  130.     
  131.     BYTE    cdsc_audiostatus;    /* see below */
  132.     unsigned    cdsc_resvd:    8;    /* reserved */
  133.     unsigned    cdsc_adr:   4;    /* see above */
  134.     unsigned    cdsc_ctrl:  4;    /* see above */
  135.     BYTE    cdsc_trk;            /* current track */
  136.     BYTE    cdsc_ind;            /* current index */
  137.     cd_ad    cdsc_absaddr;        /* absolute address */
  138.     cd_ad    cdsc_reladdr;        /* track relative address */
  139. };
  140.  
  141. struct cdrom_mcn 
  142. {
  143.     BYTE    mcn_audiostatus;    /* see above */
  144.     BYTE    mcn_mcn[23];        /* Media catalog number as ASCII string */
  145. };
  146.  
  147. struct cdrom_tisrc
  148. {
  149.     /* input parameters */
  150.  
  151.     BYTE    tisrc_track;        /* track number */
  152.     
  153.     /* output parameters */
  154.     
  155.     BYTE    tisrc_audiostatus;    /* see above */
  156.     BYTE    tisrc_tisrc[23];    /* Track International Standard
  157.                                     Recording Code (ASCII) */
  158. };
  159.  
  160. struct cdrom_volctrl
  161. {
  162.     BYTE    channel0;            /* volume level 0..255 */
  163.     BYTE    channel1;
  164.     BYTE    channel2;
  165.     BYTE    channel3;
  166. };
  167.  
  168. struct cdrom_audioctrl
  169. {
  170.     /* input parameters */
  171.  
  172.     short    set;    /* 0 == inquire only */
  173.     
  174.     /* input/output parameters */
  175.     
  176.     struct {
  177.         BYTE selection;
  178.         BYTE volume;
  179.     } channel[4];
  180. };
  181.  
  182. struct cdrom_read      
  183. {
  184.     long    cdread_lba;            /* logical block address */
  185.     char    *cdread_bufaddr;    /* buffer pointer */
  186.     long    cdread_buflen;        /* byte count */
  187. };
  188.  
  189.  
  190. /* CD-ROM address types */
  191.  
  192. #define CDROM_LBA   0x01
  193. #define CDROM_MSF   0x02
  194.  
  195. /* SUB Q control bits */
  196.  
  197. #define CDROM_AUDIO_EMPHASIS    0x01
  198. #define CDROM_COPY_PERMITTED    0x02
  199. #define CDROM_DATA_TRACK        0x04
  200. #define CDROM_FOUR_CHANNEL      0x08
  201.  
  202. /* The leadout track is always 0xAA, regardless of # of tracks on disc */
  203.  
  204. #define CDROM_LEADOUT   0xAA
  205.  
  206. /* return value from READ SUBCHANNEL DATA */
  207.  
  208. #define CDROM_AUDIO_INVALID     0x00    /* audio status not supported */
  209. #define CDROM_AUDIO_PLAY        0x11    /* audio play operation in progress */
  210. #define CDROM_AUDIO_PAUSED      0x12    /* audio play operation paused */
  211. #define CDROM_AUDIO_COMPLETED   0x13    /* audio play successfully completed */
  212. #define CDROM_AUDIO_ERROR       0x14    /* audio play stopped due to error */
  213. #define CDROM_AUDIO_NO_STATUS   0x15    /* no current audio status to return */
  214.  
  215. /* CD-ROM Fcntl opcodes */
  216.  
  217. /* Get block number of first sector in last session of a multisession
  218.    CD. Argument points to a LONG. Used by iso9660f.dos */
  219. #define CDROMREADOFFSET     (('C'<<8)|0x00)
  220.  
  221. /* Pause audio operation */
  222. #define CDROMPAUSE          (('C'<<8)|0x01)
  223.  
  224. /* Resume audio operation */
  225. #define CDROMRESUME         (('C'<<8)|0x02)
  226.  
  227. /* Play audio. Argument points to cdrom_msf structure */
  228. #define CDROMPLAYMSF        (('C'<<8)|0x03)
  229.  
  230. /* Play audio. Argument points to cdrom_ti structure */
  231. #define CDROMPLAYTRKIND     (('C'<<8)|0x04)
  232.  
  233. /* Read header of table of contents. Argument points to cdrom_tochdr
  234.    structure */
  235. #define CDROMREADTOCHDR     (('C'<<8)|0x05)
  236.  
  237. /* Read a toc entry. Argument points to cdrom_tocentry structure */
  238. #define CDROMREADTOCENTRY   (('C'<<8)|0x06)
  239.  
  240. /* Stops spindle motor */
  241. #define CDROMSTOP           (('C'<<8)|0x07)
  242.  
  243. /* Starts spindle motor */
  244. #define CDROMSTART          (('C'<<8)|0x08)
  245.  
  246. /* Eject medium */
  247. #define CDROMEJECT          (('C'<<8)|0x09)
  248.  
  249. /* Sets audio playback volume. Argument points to cdrom_volctrl
  250.    structure. Only for compatibility to Unix drivers, see also
  251.    CDROMAUDIOCTRL */
  252. #define CDROMVOLCTRL        (('C'<<8)|0x0a)
  253.  
  254. /* Read subchannel information. Argument points to cdrom_subchnl
  255.    structure. */
  256. #define CDROMSUBCHNL        (('C'<<8)|0x0b)
  257.  
  258. /* Read Mode 2 or 1 sectors. Argument points to cdrom_read
  259.    structure. Blocks have either 2336 or 2048 bytes. */
  260. #define CDROMREADMODE2      (('C'<<8)|0x0c)
  261. #define CDROMREADMODE1      (('C'<<8)|0x0d)
  262.  
  263. /* Lock eject mechanism */
  264. #define CDROMPREVENTREMOVAL (('C'<<8)|0x0e)
  265.  
  266. /* Unlock eject mechanism */
  267. #define CDROMALLOWREMOVAL   (('C'<<8)|0x0f)
  268.  
  269. /* Control audio settings. Argument points to cdrom_audioctrl
  270.    structure */
  271. #define CDROMAUDIOCTRL      (('C'<<8)|0x10)
  272.  
  273. /* Read Digital Audio (red book) sectors. Argument points to
  274.    cdrom_read structure. Blocks have 2352 bytes. */
  275. #define CDROMREADDA         (('C'<<8)|0x11)
  276.  
  277. /* Read media catalog number. Argument points to cdrom_mcn
  278.    structure */
  279. #define CDROMGETMCN         (('C'<<8)|0x13)
  280.  
  281. /* Read track international standard recording code. Argument points
  282.    to cdrom_tisrc structure */
  283. #define CDROMGETTISRC       (('C'<<8)|0x14)
  284.  
  285. #endif  _CDROMIO_H
  286.